home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / menu / list77a.zip / LISTMOD.DOC < prev    next >
Text File  |  1992-10-07  |  19KB  |  670 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                  LIST 
  14.  
  15.  
  16.                             CUSTOMIZATION GUIDE 
  17.  
  18.  
  19.                        A File Viewing and Browsing Utility 
  20.  
  21.                        Version 7.7            October 1992 
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.         (c) Copyright  Vernon D. Buerg 1983-92.  All rights reserved 
  43.  
  44.         LIST is a copyrighted program.  LIST is NOT public domain. 
  45.  
  46.         LIST may copied for personal use only subject to the restrictions 
  47.         set forth in the last chapter. 
  48.  
  49.             T A B L E   O F   C O N T E N T S
  50.  
  51. __________________________________________________________________________
  52.  
  53.  
  54. Modifying LIST.COM  ................................................... 1    
  55.      Locations of option values  ...................................... 1    
  56.         LIST Plus only  ............................................... 3    
  57.      Reassigning keys  ................................................ 5    
  58.      Table of Routines  ............................................... 6    
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101. Contents 1                                             LIST  User's Guide 
  102. Modifying LIST.COM 
  103. ______________________________________________________________________________
  104.  
  105.  Locations of option values 
  106.  
  107.  
  108.     This information is offered to those of you who wish to modify  LIST 
  109.     in special ways.  You do not need this information to use LIST.   An 
  110.     alternative to cloning  is to use  DEBUG to make  permanent changes. 
  111.     Also, a special customization program called LISTOPT is available to 
  112.     registered and licensed users.  Subtract hex 100 if  you are using a 
  113.     a file editor instead of DEBUG. 
  114.  
  115.     Here is a list of key items and their addresses: 
  116.  
  117.     Item           Offset  Value    Description of contents 
  118.     -------------- ------  -----    ----------------------- 
  119.     Special         0132    70      Top/bottom line colors 
  120.         Special lines 1 and 25 colors, default is 70 (reverse). 
  121.         Refer to a technical reference guide for the 
  122.         attribute values for the colors that you want. 
  123.  
  124.     Normal          0134    07      Text colors 
  125.     Bright          0136    09      Find/Scan line colors 
  126.  
  127.     Window 1 color  0138    07      Primary window text color 
  128.     Window 2 color  0139    0F      Second window text color 
  129.  
  130.     Flag3           013A    09      Retrace off and junk filter on 
  131.  
  132.     By specifying the bit value, the option is enabled.  For example, to 
  133.     enable Shared and Retrace, specify a hex value of the sum, or  01+04 
  134.     = 05. 
  135.                MRSJ WHK*  M = mono, retrace testing if off, x'01' 
  136.                           R = ruler, x'02' 
  137.                           S = shared, x'04' 
  138.                           J = add LF to lone CR, process backspaces, 
  139.                               if on, x'08'; default is off 
  140.                           W = wrap mode, x'10' 
  141.                           H = hi-bit on, x'20' 
  142.                           K = kybd flush, x'40' 
  143.                           * = special document filtering, x'80' 
  144.  
  145.     Flag4           013B    08      Tabs on 
  146.                .PAT DGV.  P = Preload file if on, x'02', default is off 
  147.                           A = Apxcore if on, TV/DD/DV if off, x'04, 
  148.                               default is for Topview/Double DOS use 
  149.                           T = if on (default), expand TABs, x'08' 
  150.                           D = hex display mode if on, x'10' 
  151.                           G = if on, Alt-G goto DOS is Disabled, x'20' 
  152.                           V = if on, screen save/restore is Disabled 
  153.                               and 9K less memory is used/required, x'40' 
  154.  
  155. LIST  User's Guide                                                    Page  1 
  156. Modifying LIST.COM 
  157. ______________________________________________________________________________
  158.  
  159.  Locations of option values 
  160.  
  161.  
  162.     Find row        013C    0800    Position of found line on screen, 8 
  163.     Row less one at which found text is displayed,  1 byte the default 
  164.     is 08 which displays found text on line  9 
  165.  
  166.     When the  Find/Scan command  is used,  the next  line which contains 
  167.     that text is highlighted using the 'bright' color, and is placed  in 
  168.     row 9 of the screen.  You can change the row by Altering the byte at 
  169.     location 13C which is normally '08', one less than the row. 
  170.  
  171.     Scroll incr     013E    0A00    Left/right scroll increment, 10 
  172.     Scroll start    0140    0000    Starting scroll offset, 0 
  173.     Tab value       0142    0800    Tab interval, 8 
  174.     Tab mask        0144    F8FF    Tab bit mask 
  175.     Loudness        0146    C8      Beep tone level 
  176.     Key rate        0148    FF      Continuous scroll increment, 255 
  177.     Overlap         0149    0000    PgUp/PgDn scroll overlap, 0 
  178.     Wildcard esc    014B    26      Scan/Find wildcard ? escape character 
  179.     Alt-V up        014C    0500    Alt-V display files per line, 5 
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209. Page  2                                                    LIST  User's Guide 
  210. Modifying LIST.COM 
  211. ______________________________________________________________________________
  212.  
  213.  Locations of option values 
  214.  
  215.  
  216.     LIST Plus only 
  217.     -------------- 
  218.     Eye-catcher     014E    'COM:' 
  219.     COM port        0152    F803    Default for COM1, use F802 for COM2 
  220.  
  221.     Sort offset     0154    00      Default sort key offset 
  222.                                 00 by filename 
  223.                                 08 by extension 
  224.                                 0C by datestamp 
  225.                                 10 by file size 
  226.  
  227.     Flag6           0156    00      Plus options 
  228.                                 04  suppress "Are you sure?" prompts 
  229.                                 10  send FF formfeed after ctrl-P 
  230.                                 40  /Q option, suppress beeps 
  231.                                 80  /V option, verify file copies 
  232.  
  233.     Modem init      0157    'AT'    30-byte modem initialization string 
  234.     Editor name     0175    'Edit'  8-byte name of editor program 
  235.     Modem hang-up   017E    'ATZ'   9-byte modem disconnect command 
  236.     Temp var name   0187    LIST    4-character environment name for temps 
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. LIST  User's Guide                                                    Page  3 
  264. Modifying LIST.COM 
  265. ______________________________________________________________________________
  266.  
  267.  Locations of option values 
  268.  
  269.     The following offsets change from version to version. Look for the 
  270.     eye-catchers to be sure of the offset: 
  271.  
  272.     Key table       0473    'WHAT'  Eye catcher 
  273.                     0477    0026    Key command table 
  274.     Routines        057C    'WHERE' Eye catcher 
  275.                     0581    xxxx    Command routines 
  276.  
  277.     Examples of using DEBUG can be found in the DIALER.PAT and 
  278.     COLORS.PAT files. To use them, copy LIST.COM to the current 
  279.     directory and issue the DEBUG command. For example: 
  280.  
  281.             DEBUG <DIALER.PAT 
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317. Page  4                                                    LIST  User's Guide 
  318. Modifying LIST.COM 
  319. ______________________________________________________________________________
  320.  
  321.  Reassigning keys 
  322.  
  323.     LIST performs a function for every character that can be entered  at 
  324.     the command line prompt.  There  are 128 regular characters and  131 
  325.     extended characters.  The regular characters are numbered from 0  to 
  326.     127, and  they include  the letters  A-Z, a-z,  the numbers, and the 
  327.     rest of  the usual  single characters  found on  your keyboard.  The 
  328.     extended characters represent special function keys and combinations 
  329.     of keys, such as F1, Alt-X, Ctrl-A, and the cursor positioning keys. 
  330.  
  331.     The  WHAT  table  in  LIST  has  a  one  byte  entry for each of the 
  332.     characters.  This byte is a number from 0 to 57 that represents  the 
  333.     identification of a routine that performs a function. 
  334.  
  335.         For example, 
  336.  
  337.           - the ESCape key has a value  of 27 (hex 1B) and its value  in 
  338.             the WHAT table is 16 (10 hex).  Routine number 16 is  called 
  339.             "Done".  The "Done" routine exits to DOS. 
  340.  
  341.           - the Q key has a value of 81 (51 hex) with a routine value of 
  342.             15  for  the  "Close"  routine.   The  "Close"  routine ends 
  343.             viewing of the  current file and  tries to display  the next 
  344.             file, i.e. wildcards used for the filename.  There is also a 
  345.             lower case letter q, so be sure to change both entries. 
  346.  
  347.     To change the function that a command character performs, you change 
  348.     the  value  in  the  WHAT  table  for the routine that the character 
  349.     invokes. 
  350.  
  351.     For example, to  change the ESCape  key to act  like the Q  key, you 
  352.     change the routine  value for ESCape  from 16 (10  hex) to a  15 (0F 
  353.     hex). 
  354.  
  355.     To find the location of the  routine value in the WHAT table,  first 
  356.     determine the value of the  character, e.g.  ESCape is 27  (1B hex), 
  357.     and then add that to the  location of the WHAT table (36C  hex); or, 
  358.     1B + 36C = 387 hex.  Finally,  use DEBUG to change the byte at  that 
  359.     location (387 hex) from a 10 hex to a 0F hex. 
  360.  
  361.     For example, 
  362.  
  363.           debug list.com                ; use appropriate file name 
  364.           -e 387 0f                     ; change ESC to routine 15 
  365.           -w                            ; old data is 10 
  366.           -q 
  367.  
  368.  
  369.  
  370.  
  371. LIST  User's Guide                                                    Page  5 
  372. Modifying LIST.COM 
  373. ______________________________________________________________________________
  374.  
  375.  Table of Routines 
  376.  
  377.  
  378.     Value Key(s)               Description of function performed 
  379.     ----- ---------            ------------------------------------------ 
  380.       0                        Error, undefined command 
  381.  
  382.       2   Alt-E                Toggle EGA 43-line mode 
  383.  
  384.       3   Alt-F, G             Get new filespec 
  385.  
  386.       4   Alt-J                Toggle Junk filter 
  387.  
  388.       5   Alt-L                Toggle pre-Load 
  389.  
  390.       6   Alt-T                Toggle TABs expansion 
  391.  
  392.       7   Alt-W                Toggle Split windows 
  393.  
  394.       8   Alt-X                Exit to DOS, restore screen 
  395.  
  396.       9   U/up                 Position to previous line 
  397.  
  398.      10   END, B               Position to end of file 
  399.  
  400.      11   F7                   Change top/bottom line background color 
  401.  
  402.      12   F8                   Change top/bottom line foreground color 
  403.  
  404.      13   Ctrl-HOME            Position to specified line number 
  405.  
  406.      14   Alt-C                Rewrite LIST.COM with new options 
  407.  
  408.      15   Q, Ctrl-PgDn         Quit current file, display next file 
  409.  
  410.      16   ESC, F10             Exit to DOS 
  411.  
  412.      17   N, down              Position to next line 
  413.  
  414.      18   X                    Exit to DOS, clear screen 
  415.  
  416.      19   Alt-H                Toggle Hex display mode 
  417.  
  418.      20   8                    Leave hi-bit 
  419.  
  420.      21   \, F                 Search for text, any case matches 
  421.  
  422.      22   F2                   Change Find/Scan background color 
  423.  
  424.  
  425. Page  6                                                    LIST  User's Guide 
  426. Modifying LIST.COM 
  427. ______________________________________________________________________________
  428.  
  429.  Table of Routines 
  430.  
  431.     Value Key(s)              Description of function performed 
  432.     ----- ---------           ------------------------------------------ 
  433.      23   F4                  Change Find/Scan foreground color 
  434.  
  435.      24   Alt-M               Toggle monitor rescan testing 
  436.  
  437.      25   K, Alt-K            Toggle keyboard flush (type ahead) 
  438.  
  439.      26   Alt-G               Invoke DOS command (shell) 
  440.  
  441.      27   L, left             Scroll left 10 columns 
  442.  
  443.      28   -                   Position back by number of lines 
  444.  
  445.      29   enter               Display next page 
  446.  
  447.      30   +                   Position forward by number of lines 
  448.  
  449.      31   P                   Print current screen or marked lines 
  450.  
  451.      32   F1 H ?              Display Help screen 
  452.  
  453.      33   F3, A               Search for next occurrence of text 
  454.  
  455.      34   R right             Scroll display right 10 columns 
  456.  
  457.      35   Alt-R               Display ruler marks on top line 
  458.  
  459.      36   /, S                Search for text, same case 
  460.  
  461.      37   F9                  Search for previous occurrence of text 
  462.  
  463.      38   Ctrl-left           Reset scroll to column 1, full left 
  464.  
  465.      39   F5                  Change normal line background color 
  466.  
  467.      40   F6                  Change normal line foreground color 
  468.  
  469.      41   7                   Strip hi-bit 
  470.  
  471.      42   Alt-S               Toggle closing of files 
  472.  
  473.      43   *                   Toggle special * filter 
  474.  
  475.      44   Home, T             Position to top of file 
  476.  
  477.  
  478.  
  479. LIST  User's Guide                                                    Page  7 
  480. Modifying LIST.COM 
  481. ______________________________________________________________________________
  482.  
  483.  Table of Routines 
  484.  
  485.     Value Key(s)              Description of function performed 
  486.     ----- ---------           ------------------------------------------ 
  487.  
  488.      45   B, up               Position back one line 
  489.  
  490.      46   W                   Toggle display of wide lines 
  491.  
  492.      47   Alt-D               Write marked lines, or found line, to a file 
  493.  
  494.      48   Alt-M               Mark top line of display 
  495.  
  496.      49   Alt-U               Unmark lines 
  497.  
  498.      50   Alt-B               Mark bottom line of display 
  499.  
  500.      51   Ctrl-pgup           Display previous file 
  501.  
  502.      52   ^                   Like Find but initiates search backwards 
  503.  
  504.      53   v                   Like Scan but initiates search backwards 
  505.  
  506.      54   Alt-N               Toggle screen saving (Alt-X) function 
  507.  
  508.      55   C                   Toggle continuous scrolling 
  509.  
  510.      56   Alt-Y               Bookmark, reposition to last "active" line 
  511.  
  512.      57   Alt-O               Write marked lines to previous Alt-D file 
  513.  
  514.      58   Ctrl-F              Sends formfeed control character to printer 
  515.  
  516.      59   Alt-A               Continues text search across files 
  517.  
  518.      60   Ctrl-P              Print the entire file 
  519.  
  520.      61   Alt-I               Grab a filespec from the display 
  521.  
  522.      62   Alt-V               File selection menu 
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533. Page  8                                                    LIST  User's Guide 
  534. Modifying LIST.COM 
  535. ______________________________________________________________________________
  536.  
  537.  Table of Routines 
  538.  
  539.     Value Key(s)              Description of function performed 
  540.     ----- ---------           ------------------------------------------ 
  541.  
  542.      63   ESCape              Exit from Alt-V file menu 
  543.  
  544.      64   Alt-Z               Toggle line 25 command line display format 
  545.  
  546.      65   Ctrl-V              Switch display window 
  547.  
  548.      66   Ctrl-T              Grab a telephone number and dial the modem 
  549.  
  550.      67   Ctrl-H              Disconnect modem (hang up) 
  551.  
  552.      68   Ctrl-I              Redefine Tab stop interval 
  553.  
  554.      69   Ctrl-Y              Set new bookmark line number for recall 
  555.  
  556.      70   1                   Restart displaying files with the first file 
  557.  
  558. ***  71   E                   ASCII or EBCDIC display mode 
  559.  
  560. ***  72   Ctrl-K              Toggle display of line numbers on each line 
  561.  
  562. ***  73   Ctrl-B              Set record size for fixed length records 
  563.  
  564.      74   Ctrl-right          Scroll full right 
  565.  
  566.      75   O                   Toggle date format, US or European 
  567.  
  568.      76   Alt-Q               Toggle quiet mode 
  569.  
  570. ***  77   Shift-F5            Change line number foreground 
  571.  
  572. ***  78   Shift-F6            Change line number background 
  573.  
  574. ***  79   ctrl-O              Toggle normal and condensed laser printer mode 
  575.  
  576. Note: *** indicates that the function is available in LIST Enhanced only 
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587. LIST  User's Guide                                                    Page  9 
  588. Index-1                                                LIST  User's Guide 
  589. __________________________________________________________________________
  590.  
  591.  
  592.  
  593.   /Q,command line,quiet mode ... 3
  594.   /V,command line,verify mode .. 3
  595.   Alt-A,find text again ........ 8
  596.   Alt-B,mark bottom line ....... 8
  597.   Alt-C,clone new LIST.COM ..... 6
  598.   Alt-D,Write marked lines ..... 8
  599.   Alt-E,toggle 25/43 lines ..... 6
  600.   Alt-F,enter new filename ..... 6
  601.   Alt-G,go to DOS .............. 1, 7
  602.   Alt-H,toggle hex display ..... 6
  603.   Alt-I,insert filename ........ 8
  604.   Alt-J,toggle junk filter ..... 6
  605.   Alt-K,toggle key ahead ....... 7
  606.   Alt-L,toggle file preloading . 6
  607.   Alt-M,mark top line .......... 7, 8
  608.   Alt-N,toggle screen saving ... 8
  609.   Alt-O,write marked lines ..... 8
  610.   Alt-Q,toggle quiet mode ...... 9
  611.   Alt-R,toggle ruler display ... 7
  612.   Alt-S,toggle file sharing .... 7
  613.   Alt-T,toggle TAB expansion ... 6
  614.   Alt-U,unmark lines ........... 8
  615.   Alt-V,Change Directories ..... 2, 8, 9
  616.   Alt-W,freeze top window ...... 6
  617.   Alt-X,exit to DOS ............ 5, 6, 8
  618.   Alt-Y,reposition to last line  8
  619.   Alt-Z,Toggle command line .... 9
  620.   Bookmark,recall position ..... 8, 9
  621.   Cloning ...................... 1
  622.   Colors ....................... 1, 4
  623.   Command line,option switches . 5, 9
  624.   Continuous,scrolling ......... 2, 8
  625.   Ctrl-A,Full left scroll ...... 5
  626.   Ctrl-F,Send printer formfeed . 8
  627.   Ctrl-HOME,Position to a line . 6
  628.   Ctrl-H,Hang up phone ......... 9
  629.   Ctrl-I,Define TAB interval ... 9
  630.   Ctrl-left,Position to column 1 7
  631.   Ctrl-PgDn,Show next file ..... 6
  632.   Ctrl-PgUp,Show previous file . 8
  633.   Ctrl-P,Print entire file ..... 3, 8
  634.   Ctrl-right,Scroll full right . 9
  635.   Ctrl-T,Dial telephone ........ 9
  636.   Ctrl-V,Switch windows ........ 9
  637.  
  638. LIST  User's Guide                                                 Index-2
  639. __________________________________________________________________________
  640.  
  641.  
  642.  
  643.   Ctrl-Y,Set bookmark .......... 9
  644.   DEBUG,changing options ....... 1, 4, 5
  645.   Environment,DOS .............. 3
  646.   Exit to DOS .................. 6
  647.   F10,Exit to DOS .............. 6
  648.   F1,Display Help .............. 5, 7
  649.   F2,Find background color ..... 6
  650.   F3,Find next ................. 7
  651.   F4,Find foreground color ..... 7
  652.   F5,Text background color ..... 7, 9
  653.   F6,Text foreground color ..... 7, 9
  654.   F7,Status background color ... 6
  655.   F8,Status foreground color ... 6
  656.   F9,Find previous ............. 7
  657.   Filtering .................... 1
  658.   Find,text .................... 1, 2, 5, 6, 7, 8
  659.   Hi-bit,filter usage .......... 1, 6, 7
  660.   Junk,filter usage ............ 1, 6
  661.   LIST Enhanced ................ 9
  662.   LIST Plus only ............... 3
  663.   Print,files or lines ......... 7, 8
  664.   Scan,for text ................ 1, 2, 6, 7, 8
  665.   Screen saving,option ......... 8
  666.   Shell,to DOS ................. 7
  667.   TAB,control character ........ 2, 9
  668.   Wrap,filter .................. 1
  669.  
  670.